Your Choice 3/Your Choice Software Collection 3.iso/os2/grfcdemo/demo.@/GRAPHIC2.HLP

OS/2 Help File | 1994-05-17 | 16.2 KB | 473 lines

ΓòÉΓòÉΓòÉ 1. File ΓòÉΓòÉΓòÉ

The File menu contains commands that you use to print GraphiC pictures, set
preferences, and exit the program. Play also contains a choice for opening a
.TKF file for viewing. The following commands appear in the File menu:

Open
     Opens a .TKF file for viewing (Play only)

Print
     Prints the current picture

Preferences
     Allows you to save the current window and printer settings

Skip (Play only)
     Skips to the specified picture in a .TKF file

Hold (Demo only)
     Pause for 1 minute

Exit
     Quits the application


ΓòÉΓòÉΓòÉ 1.1. File Open ΓòÉΓòÉΓòÉ

You can open a .TKF file that was previously created with GraphiC by using the
Open command. This option is for Play only.

To open a file, do the following:

o Select the File menu and choose the Open command.

o Select the file from the File Open dialog box.

The File Open dialog box appears, showing you a list of files in the current
directory with a .TKF extension. Use the dialog box to select the path and file
name of the file you wish to view.


ΓòÉΓòÉΓòÉ 1.2. File Print ΓòÉΓòÉΓòÉ

You use the Print command to print the picture displayed in the window.
Pictures which have been zoomed in or zoomed out will be printed as they appear
in the window.

To print a displayed picture, select the File menu and choose the Print
command.


ΓòÉΓòÉΓòÉ 1.3. File Preferences ΓòÉΓòÉΓòÉ

You use the Preferences choice to save the current window sizes or locations
and the printer settings.

To save the size and location of the GraphiC picture window and the GraphiC
text window, follow these steps:

 1. Position and size the window as desired

 2. Select the File menu and choose Preferences

 3. Select Save window settings

To set up your printer options:

 1. Select the File menu and choose Preferences

 2. Select Printer setup

A dialog box will appear which contains all of the printer options. After you
have finished making your choices you can save the settings in the GraphiC
initialization file by selecting the Save button. If you do not select Save,
the settings will remain active until you exit the application or until you
change them.


ΓòÉΓòÉΓòÉ 1.4. Hold (Demo only) ΓòÉΓòÉΓòÉ

Causes the Demo to pause for 1 minute. Hitting the Enter key will cause the
Demo to continue.


ΓòÉΓòÉΓòÉ 1.5. File Exit ΓòÉΓòÉΓòÉ

You quit the application by using the Exit command.

To quit a GraphiC application select the File menu and choose the Exit command.


ΓòÉΓòÉΓòÉ 2. Edit ΓòÉΓòÉΓòÉ

The Edit menu contains commands that you use to copy GraphiC pictures to the
clipboard. The pictures can be coppied as standard OS/2 Metafiles or as
bitmaps.

The following commands appear in the File menu:

Copy (Bitmap)   Copies the current GraphiC window to the clipboard as a bitmap

Copy (Metafile) Copies the current picture to the clipboard as a metafile

If the picture has been zoomed the zoomed image will be copied.


ΓòÉΓòÉΓòÉ 3. Draw ΓòÉΓòÉΓòÉ

The Draw menu contains commands that you use to control the GraphiC display.

Draw next      Draws the next picture

Redraw         Redraws the current picture from the .TKF file

Zoom in        Allows you to zoom in on the picture

Zoom out       Allows you to shrink and position the plot

Skip (Play only) Select a picture within a series. If a .OFF file exists for
               the .TKF file being viewed, Play will jump to picture 'n':
               otherwise, Play skips 'n' pictures

Hold (GraphiC Demo only) Causes the Demo to pause


ΓòÉΓòÉΓòÉ 3.1. Draw next ΓòÉΓòÉΓòÉ

The Draw next command will draw the next picture in the series. If you are
running Play and are at the end of the file Play exits. If you are running your
application, the program returns from the call to endplot().

A carriage return may be used instead of the menu.


ΓòÉΓòÉΓòÉ 3.2. Redraw ΓòÉΓòÉΓòÉ

The Redraw command causes the picture to be redrawn from the .TKF file. If the
picture has been zoomed the plot will return to its original size.


ΓòÉΓòÉΓòÉ 3.3. Zoom in ΓòÉΓòÉΓòÉ

The Zoom in command allows you to specify a region to zoom. To specify a zoom
region, position the mouse arrow where you want the lower left corner of the
zoom region. Click the left mouse button. At this time the mouse pointer will
change to cross hairs. As you move the mouse a rubber band box will be
displayed around the area to be zoomed. Position the cross hairs where you want
upper right corner and click the right mouse button. The area within the box
will be redrawn to fill the window.

You can reanchor the lower left corner any time by clicking the left mouse
button at the new location.

If you choose to zoom in again the plot will be redrawn in its original size
before you can select the zoom region.

You can output the zoomed image with any of GraphiC's output options.


ΓòÉΓòÉΓòÉ 3.4. Zoom out ΓòÉΓòÉΓòÉ

The Zoom out command allows you to specify a region in the window in which to
redraw the plot. To specify the region, position the mouse arrow where you want
the lower left corner. Click the left mouse button. At this time the mouse
pointer will change to cross hairs. As you move the mouse a rubber band box
will be displayed. Position the cross hairs where you want upper right corner
and click the right mouse button. The plot will then be redrawn inside the
rectangle.

You can reanchor the lower left corner any time by clicking the left mouse
button at the new location.

If you choose to zoom out again the plot will be redrawn in its original size
before you can select the zoom region.

You can output the reduced picture with any of GraphiC's output options.


ΓòÉΓòÉΓòÉ 3.5. Skip (Play only) ΓòÉΓòÉΓòÉ

Allows you to skip to any picture within a .TKF file. To skip to a particular
picture choose the number of the desired picture from the skip dialog box.

When Skip is chosen, Play uses a .OFF file to get the offset into the .TKF file
to the begining of the desired picture. If the .OFF file is not present the
program skips the specified number of pictures.


ΓòÉΓòÉΓòÉ 4. Convert ΓòÉΓòÉΓòÉ

The Convert menu contains the file conversion choices. The following choices
are provided:

Bitmap
  Convert to an OS/2 bitmap file
CGM
  Convert to a Computer Graphics Metafile format
GEM
  Convert to a Digital Research GEM format
HPGL
  Convert to a Hewlett Packard Graphics Language level 1 format
HPGL2
  Convert to a Hewlett Packard Graphics Language level 2 format
Metafile
  Convert to an OS/2 standard metafile
PIC
  Convert to a Lotus PIC format
PostScript
  Convert to an Encapsulated PostScript format with or without a TIFF header
SCODL
  Convert to a SCODL film recorder format
TIFF
  Convert to a TIFF format


ΓòÉΓòÉΓòÉ 5. General help ΓòÉΓòÉΓòÉ

This window and its associated plot were created using the GraphiC library from
Scientific Endeavors Corporation. The contents of the plot are dependent on the
program which is linked to the library. The post processing options are
provided by GraphiC.

Any time after a plot is completed you may choose from the post processing
options. These options include converting to a particular file format, zooming
in, shrinking and positioning, redrawing, and copying to the clipboard. For
more information about these options choose help for the appropriate menu item.


ΓòÉΓòÉΓòÉ 6. Keys help ΓòÉΓòÉΓòÉ

The following is a list of accelerator keys.

Ctrl+P
  Print
Ctrl+Q
  Exit
Ctrl+W
  Zoom out
Ctrl+Z
  Zoom in
Space Bar
  Redraw the plot
Enter
  Draw next plot


ΓòÉΓòÉΓòÉ 7. Help Menu ΓòÉΓòÉΓòÉ

Use the choices on the Help pull-down to display:

Help index
     Displays the index of help menu.

General Help
     Displays some information about the GraphiC window

Keys Help
     Displays a list of keys usage.

Using Help
     Provides detailed information on the kinds of help available and how to
     use help.

Product information
     Displays the GraphiC logo dialog box and copyright information


ΓòÉΓòÉΓòÉ 7.1. Help for menuitem "Help index..." ΓòÉΓòÉΓòÉ

Selecting this menuitem will display a help index.


ΓòÉΓòÉΓòÉ 7.2. Help for menuitem "General help..." ΓòÉΓòÉΓòÉ

Selecting this item displays the general help panel.


ΓòÉΓòÉΓòÉ 7.3. Help for menuitem "Using help..." ΓòÉΓòÉΓòÉ

This menuitme displays the system help panel on how to use help.


ΓòÉΓòÉΓòÉ 7.4. Help for menuitem "Keys help..." ΓòÉΓòÉΓòÉ

This menuitem displays a list of accelerator keys


ΓòÉΓòÉΓòÉ 7.5. Help for "Product information..." ΓòÉΓòÉΓòÉ

This menuitem displays the product information dialog box.


ΓòÉΓòÉΓòÉ 8. Print Setup Dialog Box ΓòÉΓòÉΓòÉ

The Print setup dialog box gives you the opportunity to customize the printer
output. From this dialog box you can:

 1. Select from the list of installed printers

 2. Define the page size and margins

 3. Choose whether or not to print the background color

 4. Gain access to the printer's Job Properties dialog box

GraphiC queries your system to find all of the printers you have installed.
This list is displayed in the Printer Selection: drop down list box. The
printer to receive the print job will be displayed at the top of the list.

The Job Orientation: box tells you the printer's orientation (landscape or
portrait). Use the Job Properties dialog box to change this value.

The Plot size settings box contains 3 entry fields where you can specify the
top margin, the left margin, and the length of the plot. A -1 (minus one) in
the two margin entry fields will cause the plot to be centered on the page. The
units used in these fields are in inches or cm and can be selected by the
Metric units check box. You can override the selections in these fields by
checking the Fill page check box. If you choose the Fill page option the plot
will be as big as your printer/paper size combination will allow.

The way in which the plot fills the page with regard to orientation depends on
two things: One is the plot orientation on the screen. Is the top of your plot
is toward the top of the screen or to the right of the screen? The other is the
printer orientation. Is your printer is in landscape or portrait mode? If the
top of the plot is to the right and you want to fill the page with the plot be
sure your printer is in landscape mode, not portrait mode. In other words the
rotation of the plot in the GraphiC window will not affect how the system
converts window coordinates to printer coordinates.

The Print Background check box allows you to tell the printer to print the
background color. A word of caution: If your printer is not a color printer
this option may cause the picture to be completely obscured by the background.

 The The Job Properties push button will bring up the printer's Job Properties
dialog. There you can select such things as paper size, page orientation, paper
tray, etc...


ΓòÉΓòÉΓòÉ 9. HPGL Conversion Help ΓòÉΓòÉΓòÉ

This dialog box allows you to set the parameters for converting your picture to
a Hewlett Packard HPGL or HPGL2 format. From this dialog box you can:

 1. Change the name of the output file

 2. Specify the scaling

 3. Select the plot orientation

 4. Gain access to the pen configuration dialog

You can change the output file name that was selected from the File Open dialog
box by typing a new name in the File: entry field.

The Plot size settings box contains 3 entry fields where you can specify the
top margin, the left margin, and the length of the plot. A -1 (minus one) in
the two margin entry fields will cause the plot to be centered on the page. The
units used in these fields are in inches or cm and can be selected by the
Metric units check box. For HPGL2, You can override the selections in these
fields by checking the Default Scale check box. If you choose the Default Scale
the plot will fill 95% of the printable area.

The Plot Orientation selections allow you to indicate how the plot is rotated
on the screen. The conversion routines will then rotate the plot so that it
will be upright when you import it into another program such as CorelDraw.

The Pen Select push button will bring up the Pen Selection dialog box so that
you can map plot colors to the appropriate pen numbers.


ΓòÉΓòÉΓòÉ 10. HPGL Pen Selections ΓòÉΓòÉΓòÉ

Use the table in this dialog box to map the 16 base IBM colors to the
appropriate pens. The conversion routines will convert any of GraphiC's
extended colors the nearest base IBM color.


ΓòÉΓòÉΓòÉ 11. File Conversion Help ΓòÉΓòÉΓòÉ

This dialog box allows you to set the parameters for converting your picture to
a different format. From this dialog box you can:

 1. Change the name of the output file

 2. Select the plot orientation

The Plot Orientation selections allow you to indicate how the plot is rotated
on the screen. The conversion routines will then rotate the plot so that it
will be upright when you import it into another program such as CorelDraw.

You can change the output file name that was selected from the File Open dialog
box by typing a new name in the File: entry field.


ΓòÉΓòÉΓòÉ 12. PostScript Conversion Help ΓòÉΓòÉΓòÉ

This dialog box allows you to set the parameters for converting your picture to
a PostScript format. From this dialog box you can:

 1. Change the output file name

 2. Choose to include color information in the output

 3. Choose to print the background

 4. Select the minimum line thickness

 5. Choose to include a TIFF image

 6. Specify that color separations be made

 7. Select the plot orientation

 8. Specify the PostScript level

 9. Gain access to the PostScript Font Selection dialog

You can change the output file name that was selected from the File Open dialog
box by typing a new name in the File: entry field.

Check the Color check box if you want color information included in the output
file.

Check the Color Background ? check box if you want the background color
information included in the output file.

You can specify the minimum line thickness by entering the pixel width for the
lines in the Line Width: entry field. Note that this value is the number of
pixels on your output device. Choose a larger value for phototypesetters.

To include TIFF information in the output file check the TIFF Header check box.
Including TIFF information will make the imported PostScript image viewable by
many image processing and desktop publishing software packages. PostScript
files with a TIFF header can not be sent directly to a printer.

The Plot Orientation selections allow you to indicate how the plot is rotated
on the screen. The conversion routines will then rotate the plot so that it
will be upright when you import it into another program such as CorelDraw.

You can produce a CMYK color separation by selecting CMYK in the Separation
group box.

You can specify PostScript Level 1 or Level 2 by selecting the appropriate
radio button in the Level group box.

If the plot you are converting was created using GraphiC's "gtext" mode you can
replace the plot's text with a PostScript font. The Fonts push button will
bring up the PostScript Fonts Selection dialog box. From there you can select
the PostScript font to use for "gtext" text.


ΓòÉΓòÉΓòÉ 13. PostScript Conversion Help ΓòÉΓòÉΓòÉ

Use this dialog box to select the font to use when printing text created with
GraphiC's "gtext" mode.


ΓòÉΓòÉΓòÉ 14. File open dialog box ΓòÉΓòÉΓòÉ

Select the file you wish to view from the File: list box or type the name in
the Open filename: entry field.

If the file you want is not in the current directory, you can change the drive
and directory with the Drive: and Directories: list boxes. You can also enter a
fully qualified file name in the Open filename: entry field.


ΓòÉΓòÉΓòÉ 15. Message box help ΓòÉΓòÉΓòÉ

This application demonstrates the use of the Help Manager to provide online
help for an application. Help for both menuitems and message boxes is
demonstrated.